Summary

This PR adds generic queue job lifecycle events with an optional bridge for Sentry integration. This is an alternative to PRs #449 and #452, providing a middle-ground approach.

Generic Events

The plugin now dispatches standard lifecycle events:

• Queue.Job.created - when a job is added to the queue
• Queue.Job.started - when a worker begins processing a job
• Queue.Job.completed - when a job finishes successfully
• Queue.Job.failed - when a job fails (with exception data)

These events are useful for any monitoring, logging, or external integration.

Optional Sentry Integration

For lordsimal/cakephp-sentry integration, users can register the included CakeSentryEventBridge:

// In Application::bootstrap()
use Cake\Event\EventManager;
use Queue\Event\CakeSentryEventBridge;

EventManager::instance()->on(new CakeSentryEventBridge());

This bridges the generic events to CakeSentry.Queue.* events that the Sentry plugin listens to.

Key Benefits

Related Issues

• Missing Sentry features LordSimal/cakephp-sentry#17
• add generic queue tracing feature LordSimal/cakephp-sentry#43
• Alternative to Add queue job lifecycle events for monitoring integration #449 and Add CakeSentry.Queue.* events for Sentry integration #452

Test plan

• Test for Queue.Job.created event
• Test for Queue.Job.started event
• Test for Queue.Job.completed event
• Test for Queue.Job.failed event
• Tests for CakeSentryEventBridge listener
• All 137 tests pass
• Documentation updated